Own domain

Alby allows you to use your lightning addresses with custom domains. This is how you do it.

Please read and fill out the form first. To use your own domain, you will need to upload a file to the server of your own domain. We need a way to contact and inform you, if the file requires a change. For advanced users, we recommend setting up a redirect rather than hosting a copy of your lightning address data.

1️⃣ Setup your @getalby.com lightning address

Sign up for your Alby account and choose a lightning address.

2️⃣ Find your LNURL

Open https://getalby.com/.well-known/lnurlp/<username> in your browser and save this document to your local computer. (CTRL+S) Remove the filename extension (e.g. json) from the file.

Your username is the part before the @ in your lightning address: [e-mail]

You should now have a file named <username> (no file extension) and with contents similar to this one:

Example

{
   "status":"OK",
   "tag":"payRequest",
   "commentAllowed":255,
   "callback":"https://getalby.com/lnurlp/hello/callback",
   "metadata":"[[\"text/identifier\",\"[e-mail]\"],[\"text/plain\",\"Sats for Alby\"]]",
   "minSendable":1000,
   "maxSendable":11000000000,
   "payerData":{
      "name":{
         "mandatory":false
      },
      "email":{
         "mandatory":false
      }
   },
   "nostrPubkey":"79f00d3f5a19ec806189fcab03c1be4ff81d18ee4f653c88fac41fe03570f432",
   "allowsNostr":true
}

Please, do not change the content of that file!

3️⃣ Upload the file to your website

Your hostname must be hosted on the root domain (no www).

Upload the file from the step before to this location:

https://<your_domain>/.well-known/lnurlp/<your_username>

Make sure the .well-known/lnurlp folder is created within the publicly accessible root on your server (such as "www" or "public-html"). This depends on what server you use.

Example

You want to setup [e-mail] as your lightning address. Upload the file to your webhost so it's available via this URL:

https://example.com/.well-known/lnurlp/me

You should be able to open this URL in your browser. Try to send a payment to your newly created lightning address to test if everything works.

✅ That's it. You just set up a custom lightning address! 🙌

Contact us if you need help.